Screens Pre-Upgrade

You can run a pre-upgrade process that performs part of the upgrade process in advance, making the actual upgrade much faster.

The upgrade process run by the Alemba vFire Patch Tool performs several tasks, covering file replacement and database updates, including on occasion screen design updates. When these apply to multiple screens, and those screens have been modified using the vFire Designer, the upgrade can take a long time. This is due to the complexity of in-place modification of a screen design that is held in a single database field, and the often large number of screens to process. The result may be an extended period of system unavailability while the upgrade is under way.

By performing those screen updates in advance, you can reduce the upgrade time significantly, minimizing down time. The upgraded versions do not override the current screen design, but are stored in a location that is not used by the live system. Analysts and Users can therefore continue to work while the pre-upgrade is performed. All that the full upgrade has to do is swap the old and new screen designs, which is a simple and speedy process.

FAQ

From what version can I use the pre-upgrade feature?

This feature was introduced in 9.2.1, and can only be used when upgrading from that version upwards. If you try to run it on a version prior to 9.2.1, you will receive an error. For any upgrades from versions prior to that, you should run the full upgrade.

How do I run the pre-upgrade?

When you run the Alemba vFire Patch Tool, you will see a checkbox labeled “Screens pre-upgrade only”. If you check this, the only thing that the upgrade will do is take any modified screens and store an upgraded version of them in a place that does not affect the live system.

If you run the upgrade without this checked, the full upgrade will run, and any pre-upgraded screens will become the active versions of those screens.

Can I run the pre-upgrade more than once?

You can run the pre-upgrade as many times as you like before running the full upgrade, which is useful if you change the design of a screen after running the pre-upgrade. In this circumstance if you do not re-run the pre-upgrade, the screen will be upgraded during the full upgrade which may increase upgrade time. To bring up the Screens Pre-Upgrade option simply double click on the downloaded patch msi file, when prompted select to Modify the install, and run through the wizard until the Patch Tool window is displayed.

Why can't I see the pre-upgrade option?

Once you have fully upgraded the system, the pre-upgrade option will not be available, as by that point it would have nothing useful to do.

Can I run the pre-upgrade on my live system?

Yes. That is exactly what it has been designed for. All installed files remain unchanged by this process, as do all database tables other than those in which the screen designs are stored. Anyone using the screens being upgraded will not be impacted, as the design in use is not changed by the process. An upgraded copy of that design is simply stored in an unused location in that table.

Can I continue to run the old version of the system after a pre-upgrade has been run?

Yes. The system will continue to behave as before, as the system does not use the location in which the upgraded versions of the screens are stored.

Can I still run the upgrade without using the new pre-upgrade option?

Yes. The upgrade will run exactly as before. You can do this if you don’t mind how long the upgrade takes, or if you only have a few screens that have been modified. Otherwise, you are best advised to run the pre-upgrade first.

Can I make changes to my screens via the designer once I have run the pre-upgrade?

Yes. You may make changes to your screens via the designer once the pre-upgrade has been run. However, you should run the pre-upgrade again in order to save time during the full upgrade.

Before you start

Ensure that your system meets the prerequisites outlined in the Prerequisites Guide.

Familiarize yourself with the information in the Installing or Patching section, in Installing or Patching.

  1. Install the vFire Patch Tool (Installing the Patch Tool). If you have already installed it, simply run through the wizard again.
  2. The Screens Pre-upgrade window is displayed.

  3. Select the Screens Pre-upgrade box to run a screen pre-upgrade.
  4. The following window is displayed when the pre-upgrade is complete.

  5. Now you can either upgrade the system by running the upgrade, as described on Running the vFire Patch Tool, or close the window.